home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_HDF.idb / usr / freeware / catman / u_man / cat1 / hdf.Z / hdf
Encoding:
Text File  |  1999-01-26  |  11.0 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      HHHHDDDDFFFF((((1111))))         NNNNCCCCSSSSAAAA HHHHDDDDFFFF 4444....1111 ((((JJJJuuuullllyyyy 1111999999996666))))        HHHHDDDDFFFF((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       hdf -    Hierarchical Data Format library
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       ----llllmmmmffffhhhhddddffff ----llllddddffff ----lllljjjjppppeeeegggg ----llllzzzz
  13.       {{{{HHHHDDDDFFFFLLLLIIIIBBBBDDDDIIIIRRRR}}}}////lllliiiibbbbmmmmffffhhhhddddffff....aaaa {{{{HHHHDDDDFFFFLLLLIIIIBBBBDDDDIIIIRRRR}}}}////lllliiiibbbbddddffff....aaaa
  14.       {{{{HHHHDDDDFFFFLLLLIIIIBBBBDDDDIIIIRRRR}}}}////lllliiiibbbbjjjjppppeeeegggg....aaaa    {{{{HHHHDDDDFFFFLLLLIIIIBBBBDDDDIIIIRRRR}}}}////lllliiiibbbbzzzz....aaaa
  15.  
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.       HDF is a multi-object    file format that facilitates the
  19.       transfer of various types of scientific data between
  20.       machines and operating systems.  Machines currently
  21.       supported include the    Cray, HP, Vax, Sun, IBM    RS/6000,
  22.       Silicon Graphics, Macintosh, and IBM PC computers.  HDF
  23.       allows self-definitions of data content and easy
  24.       extensibility    for future enhancements    or compatibility with
  25.       other    standard formats. HDF includes Fortran and C calling
  26.       interfaces,and utilities to prepare raw image    of data    files
  27.       or for use with other    NCSA software.    The HDF    library
  28.       contains interfaces for storing and retrieving compressed or
  29.       uncompressed 8-bit and 24-bit    raster images with palettes,
  30.       n-Dimensional    scientific datasets and    binary tables. An
  31.       interface is also included that allows arbitray grouping of
  32.       other    HDF objects.
  33.  
  34.  
  35.     HHHHDDDDFFFF RRRRaaaasssstttteeeerrrr IIIImmmmaaaaggggeeeessss
  36.       HDF supports the storing of both 8-bit and 24-bit raster
  37.       images.  As well as storing information about    the dimensions
  38.       and palette of a raster image, HDF supports raster image
  39.       compression.    In previous versions of    HDF, Run-length
  40.       encoding and Imcomp compression were both supported.    With
  41.       HDF> 3.3 JPEG    compression is also available.
  42.  
  43.  
  44.     HHHHDDDDFFFF SSSScccciiiieeeennnnttttiiiiffffiiiicccc DDDDaaaattttaaaa SSSSeeeettttssss
  45.       Scientific Data Sets (SDSs) are useful for storing n-
  46.       Dimensional gridded data.  The actual    data in    the dataset
  47.       can be of any    of the "standard" number types:    8, 16 and
  48.       32bit    signed and unsigned integers and 32 and    64bit floating
  49.       point    values.     In addition, a    certain    amount of meta-data
  50.       can be stored    with an    SDS including:
  51.  
  52.         o The coordinate system to use when    interpreting or    displaying the data.
  53.         o Scales to    be used    for each dimension.
  54.         o Labels for each dimension    and the    dataset    as a whole.
  55.         o Units for    each dimension and the data.
  56.         o The valid    max and    min values for the data.
  57.         o Calibration information for the data.
  58.         o Fill or missing value information.
  59.         o Ability of have more than    one file open at a time.
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 12/16/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      HHHHDDDDFFFF((((1111))))         NNNNCCCCSSSSAAAA HHHHDDDDFFFF 4444....1111 ((((JJJJuuuullllyyyy 1111999999996666))))        HHHHDDDDFFFF((((1111))))
  71.  
  72.  
  73.  
  74.         o A    more general framework for meta-data within the    SDS data-model
  75.           (allowing    'name =    value' styel meta-data).
  76.         o Support for an "unlimited    dimension" in the SDS data-model, making
  77.           it possible to append planes to an array along one dimension.
  78.  
  79.     HHHHDDDDFFFF AAAAnnnnnnnnoooottttaaaattttiiiioooonnnnssss
  80.       Any object in    an HDF file can    have annotations associated
  81.       with it.  There are a    number of types    of annotations:
  82.  
  83.         o Labels are assumed to be short strings giving the    "name" of a
  84.           data object.
  85.         o Descriptions are longer text segments that are useful for    giving
  86.           more indepth information about a data object
  87.         o File annotations are assumed to apply to all of the objects in a
  88.           single file.
  89.  
  90.     HHHHDDDDFFFF VVVVsssseeeetttt IIIInnnntttteeeerrrrffffaaaacccceeeessss
  91.       The Vset module provides interfaces to two basic HDF
  92.       building blocks.  Vgroups are    generic    grouping elements
  93.       allowing a user to associate related objects within an HDF
  94.       file.     As Vgroups can    contain    other Vgroups, it is possible
  95.       to build a hierarchical file.     Vdatas    are data structures
  96.       made up of fields and    records.  Data is organized into
  97.       'fields' within each Vdata.  Each field is identified    by a
  98.       unique 'fieldname'.  The type    of each    field may be any of
  99.       the basic number types that HDF supports.  Fields of
  100.       different types may exist within the same Vdata.
  101.  
  102.       By combining Vdatas in Vgroups it is possible    to represent
  103.       higher level data constructs:    mesh data, multi-variate
  104.       datasets, sparse matrices, finite-element data,
  105.       spreadsheets,    splines, non-Cartesian coordinate data,    etc.
  106.  
  107.  
  108.     HHHHDDDDFFFF >>>> 3333....3333 aaaannnndddd nnnneeeettttCCCCDDDDFFFF
  109.       HDF >    3.3 merges in the netCDF library produced by Unidata.
  110.       The full netCDF library is supported as is a new "multi-
  111.       file"    SDS interface.    Both of    these interfaces can read old
  112.       netCDF files and HDF files transparently.
  113.  
  114.  
  115.  
  116.     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  117.       All HDF routines require the header "hdf.h" to be included
  118.       in the C source file.    If using the SDS routines the header
  119.       "mfhdf.h" should be included instead in in the C source
  120.       file.    Fortran    programs should    use "dffunc.inc" and
  121.       "hdf.inc".
  122.  
  123.       To compile a program that makes HDF calls on most Unix
  124.       platforms.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 12/16/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      HHHHDDDDFFFF((((1111))))         NNNNCCCCSSSSAAAA HHHHDDDDFFFF 4444....1111 ((((JJJJuuuullllyyyy 1111999999996666))))        HHHHDDDDFFFF((((1111))))
  137.  
  138.  
  139.  
  140.          HDFLIBDIR = /usr/local/lib/hdf
  141.          HDFINC    = /usr/local/include/hdf
  142.  
  143.          (FORTRAN):
  144.          f77 myprog.f -I{HDFINC} -o    myprog {HDFLIBDIR}/libmfhdf.a \
  145.          {HDFLIBDIR}/libdf.a  {HDFLIBDIR}/libjpeg.a    {HDFLIBDIR}/libz.a
  146.  
  147.          (C):
  148.          cc    myprog.c -I{HDFINC} -o myprog {HDFLIBDIR}/libmfhdf.a \
  149.          {HDFLIBDIR}/libdf.a  {HDFLIBDIR}/libjpeg.a    {HDFLIBDIR}/libz.a
  150.  
  151.  
  152.  
  153.      DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  154.       The HDF WWW page is located at http://hdf.ncsa.uiuc.edu/
  155.  
  156.       For the vast majority    of users, the "Users Guide" documents
  157.       and the "Reference" manuals should be    sufficient.
  158.  
  159.       You may download the documentation via ftp on    NCSA's
  160.       anonymous ftp    server.    (ftp.ncsa.uiuc.edu:/HDF). On anonymous
  161.       ftp there the    documentation is available in Postscript, PDF
  162.       and MIF.
  163.  
  164.  
  165.  
  166.      VVVVEEEENNNNDDDDOOOORRRR
  167.       NCSA Software    Development Division
  168.       Hierarchical Data Format Group
  169.       152 Computing    Applications Bldg.
  170.       605 E. Springfield Ave.
  171.       Champaign, IL    61820
  172.  
  173.  
  174.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  175.       4.1
  176.  
  177.      LLLLIIIICCCCEEEENNNNSSSSEEEE &&&& SSSSOOOOUUUURRRRCCCCEEEE AAAAVVVVAAAAIIIILLLLAAAABBBBIIIILLLLIIIITTTTYYYY
  178.       UNIVERSITY OF    ILLINOIS (UI), NATIONAL    CENTER FOR
  179.       SUPERCOMPUTING APPLICATIONS (NCSA), Software Distribution
  180.       Policy for Public Domain Software
  181.  
  182.       NCSA HDF Version 4.1 source code and documentation are in
  183.       the public domain, available without fee for education,
  184.       research, non-commercial and commercial purposes.  Users may
  185.       distribute the binary    or source code to third    parties
  186.       provided that    this statement appears on all copies and that
  187.       no charge is made for    such copies.
  188.  
  189.       UI MAKES NO REPRESENTATIONS ABOUT THE    SUITABILITY OF THE
  190.       SOFTWARE FOR ANY PURPOSE.  IT    IS PROVIDED "AS    IS" WITHOUT
  191.       EXPRESS OR IMPLIED WARRANTY.    THE UI SHALL NOT BE LIABLE FOR
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 12/16/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      HHHHDDDDFFFF((((1111))))         NNNNCCCCSSSSAAAA HHHHDDDDFFFF 4444....1111 ((((JJJJuuuullllyyyy 1111999999996666))))        HHHHDDDDFFFF((((1111))))
  203.  
  204.  
  205.  
  206.       ANY DAMAGES SUFFERED BY THE USER OF THIS SOFTWARE.  The
  207.       software may have been developed under agreements between
  208.       the UI and the Federal Government which entitle the
  209.       Government to    certain    rights.
  210.  
  211.       We ask, but do not require that the following    message    be
  212.       include in all derived works:
  213.  
  214.         Portions developed at the National Center for
  215.       Supercomputing
  216.         Applications at the    University of Illinois at Urbana-
  217.       Champaign.
  218.  
  219.       By copying this program, you,    the user, agree    to abide by
  220.       the conditions and understandings with respect to any
  221.       software which is marked with    a public domain    notice.
  222.  
  223.       Acknowledgements:  ----------------
  224.  
  225.       Portions of this software were developed by the Unidata
  226.       Program at the University Corporation    for Atmospheric
  227.       Research, specifically the NETCDF distribution used.
  228.  
  229.       This product also includes software developed    by the
  230.       Independent JPEG Group, specifically the IJPEG library
  231.       libjpeg.a.
  232.  
  233.       This product also includes software developed    by Jean-loup
  234.       Gailly and Mark Adler    , specifically the ZLIB    library
  235.       libz.a.
  236.  
  237.       This product includes    software developed by the University
  238.       of California, Berkeley and its contributors.
  239.  
  240.  
  241.      CCCCOOOONNNNTTTTAAAACCCCTTTT &&&& HHHHEEEELLLLPPPP
  242.       NCSA Software    Deveopment Division
  243.       Hierarchical Data Format Group
  244.       email: hdfhelp@ncsa.uiuc.edu
  245.  
  246.  
  247.      FFFFIIIILLLLEEEESSSS
  248.       ////uuuussssrrrr////llllooooccccaaaallll////lllliiiibbbb////hhhhddddffff////{{{{lllliiiibbbbmmmmffffhhhhddddffff....aaaa,,,,lllliiiibbbbddddffff....aaaa,,,,lllliiiibbbbjjjjppppeeeegggg....aaaa,,,,lllliiiibbbbzzzz....aaaa}}}}
  249.                     hdf libraries
  250.       ////uuuussssrrrr////llllooooccccaaaallll////bbbbiiiinnnn        Location of most hdf utilities
  251.       ////uuuussssrrrr////llllooooccccaaaallll////iiiinnnncccclllluuuuddddeeee////hhhhddddffff    Location of include file hdf.h
  252.                     and others
  253.  
  254.  
  255.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  256.       hhhhddddffffllllssss(1), hhhhddddffffppppaaaacccckkkk(1),    hhhhddddffffuuuunnnnppppaaaacccc(1), hhhhddddpppp(1)
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                        (printed 12/16/98)
  262.  
  263.  
  264.  
  265.